.. _cmcPmStSetCount:

cmcPmStSetCount 
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

   VT_I4 cmcPmStSetCount ([in] VT_I4 BoardID,  [in] VT_I4 Axis, [in] VT_I4 Target, [in] VT_I4 Count )                

DESCRIPTION
`````````````  

- cmcPmStSetCount() 함수는 지정한 축의 지정한 카운터 값을 새로이 설정합니다. 단, 이때 지정하는 카운터 
  값의 단위는 펄스 수입니다. 이 함수는 카운터의 값을 지정하는 매개 변수의 단위가 펄스 수라는 것을 
  제외하고는 cmcPmStGetCount() 함수와 동일합니다.  

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cmc 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardID : 사용자가 설정한 디바이스(보드) ID. 
 
▶ NodeId : 노드 번호. 노드 번호는 3부터 시작합니다. 
 
▶ Channel : 축 번호. 통합 축으로 관리되는 축 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상, 최대 
통합 축 개수 - 1 이하의 값을 축 번호로 설정할 수 있습니다. 
 
▶ Target : 설정할 카운터 번호. cmcPmStSetCount() 함수의 인자이며, 다음의 4가지 값 중의 하나이어야 
합니다. 

.. csv-table::
  :widths: 10 90
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  0(cmcCNT_COMM), Command Counter
  1(cmcCNT_FEED), Feedback Counter
  2(cmcCNT_DEV), Deviation Counter: Command 와 Feedback counter의 편차 카운터
  3(cmcCNT_GEN), General Counter: 사용자의 정의에 따라 여러 가지 용도로 사용될 수 있는 카운터

▶ Source : 대상 카운터 번호. cmcPmStGetCount() 함수의 인자이며, 이 값은 다음의 4 가지 값 중의 
하나이어야 합니다. 

.. csv-table::
  :widths: 10 90
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  0(cmcCNT_COMM), Command Counter
  1(cmcCNT_FEED), Feedback Counter
  2(cmcCNT_DEV), Deviation Counter
  3(cmcCNT_GEN), General Counter

▶ Count : 지정한 값으로 대상 카운터의 값을 설정 혹은 반환합니다. 이 값은 이 값은 논리 단위가 아닌 
실제 펄스 카운트 값입니다. 

RETURN VALUE
`````````````

.. csv-table::
  :widths: 10 90
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  음수, 수행 실패
  ERR_NONE, 수행 성공


EXAMPLE
```````````````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

    C/C++ 
    #include “ComiMLink3_SDK.h” 
    #include “ComiMLink3_SDK_Def.h” 
    long BoardID = 0; 
    //0번 축의 Command Counter를 0으로 설정합니다. 
    cmcPmStSetCount(BoardID, 3, ccmcX1, cmcCNT_COMM, 0 ); 
    //0번 축의 Feedback Counter를 0으로 설정합니다. 
    cmcPmStSetCount(BoardID, 3, ccmcX1, cmcCNT_FEED, 0 ); 
    long nCmdCounter = 0; 
    long nFdbCounter = 0; 
    //0번 축의 Command Counter값을 반환합니다. 
    cmcPmStGetCount(BoardID, 3, ccmcX1, cmcCNT_COMM, &nCmdCounter ); 
    //0번 축의 Feedback Counter값을 반환합니다. 
    cmcPmStGetCount(BoardID, 3, ccmcX1, cmcCNT_FEED, &nFdbCounter );

SEE ALSO
```````````

.. seealso:: :ref:`cmcPmStSetPosition`, :ref:`cmcPmStGetPosition`